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Systeme et precede de controle d'equipements a distance a 1'aide de 
fonctions API, dispositif et module de radiocommunication et jeu de 
fonctions correspondants. 

Le domaine de I'invention est celui du contr6le a distance d'equipements, 
et notamment d'equipements limits en ressources de traitement de donnees. 
Ainsi, I'invention s'applique par exemple aux systemes de releve de donnees a 
distance, par exemple sur des compteurs d'eau, de gaz ou d'61ectricite\ et plus 
generalement.aux systemes de telemetrie, de suivi de commandes, et plus 
generalement de controle de machines (en anglais « M to M : machine to 
machine »). 

II existe deja diverses solutions pour reviser de telles operations. Elles ont 
g6neralement ete developpees de facon specifique pour une application donnee. 
En d'autres termes, il s'agit de solutions « propri&aires », qui sont difficilement 
adaptables a d'autres applications. 

On connait par ailleurs un protocole, developpe par les societes IBM et 
ARCOM Control Systems (marques deposees), connu sous le nom de technologie 
« MQIsdp Messaging ». Cette technique propose un protocole de communication 
entre un ou plusieurs equipements limites en ressources, et un ou plusieurs 
serveurs (« brokers » en anglais), en utilisant un lien TCP/IP. 

Cependant, mSme avec ce protocole specifique, il est necessaire 
d'adjoindre aux equipements des . moyens de traitement specifiques 
(microprocesseurs, memoires, ...), qui permettent d'instaurer le dialogue avec ces 
serveurs distants, selon le format MQIsdp requis. La liaison entre l'equipement et 
le serveur peut utihser une Uaison de type telephonique, a 1'aide d'un modem. 

Dans de nombreuses applications, il serait cependant souhaitable de 
pouvoir se passer d'une liaison telephonique filaire. On peut alors envisager la 
mise en oeuvre de moyens de radiocommunication, par exemple selon la norme 
GSM ou GPRS. 



1 er ctepot 

2 



Dans ce cas, on utilisera un equipement de radiot61ephonie pour assurer la 
fonction de modem. Cependant, il reste necessaire, selon l'art anterieur, d'associer 
a l'equipement des moyens specifiques et propridtaires de traitement de donnees 
pour etablir et realiser 1'echange de donnees avec Ie serveur. 

Cet aspect est une limitation tres importante au developpement des 
applications mentionnees ci-dessus, et de nombreuses autres applications que 
permet d'envisager le protocole MQIsdp. 

L'invention a notamment pour objectif de pallier cet inconvenient de 1' art 
anterieur. 

II convient de noter que le fait d'identifier ce probleme est en soi une 
partie de l'invention. En effet, 1'homme du m6tier est persuade qu'il est 
absolument ne-cessaire d'equiper les equipements terminaux de moyens de 
traitement suffisants, et ne pent en aucun cas envisager qu'il est possible de les 
require, voire de les supprimer. 

C'est pourtant un objectif de l'invention que de permettre de simplifier les 
traitements necessaires du cdt6 des equipements, et d'eviter que ceux-ci doivent 
disposer de moyens complexes et couteux tels qu'un micro-processeur. 

Un autre objectif de l'invention est de proposer une technique simple et 
ge-nerique, permettant d'instaurer facilement et efficacement un dialogue avec un 
serveur selon le protocole MQIsdp. 

Ainsi, un objectif particulier de l'invention est de permettre d'assurer un 
tel dialogue de facon simple et peu coGteuse, a 1'aide d'un simple module de 
radiocommunication. 

Encore un autre objectif de l'invention est de fournir une telle technique, 
permettant d'etablir une liaison entre des serveurs et des Equipements par voie' 
radiotelephonique, de fa 9 on simple, standardisee et peu coQteuse. 

L'invention a egalement pour objectif de fournir une telle technique, 
permettant de developper un nombre important d' applications, sans qu'il soit 
necessaire de developper des applications specifiques a chaque fois. 

Un autre objectif de l'invention est de fournir une telle technique, ne 



necessitant pas une connaissance du protocole MQIsdp dans les applications 
developpEes. 

Encore un autre objectif de 1' invention est de fournir une telle technique, 
qui est & la fois techniqueraent simple et evolutive, et adaptable a diverses 
situations (par exemple pour la taille des donnees & 6changer) et aux eventuelles 
Evolutions futures. 

Ces objectifs, ainsi que d'autres qui apparaitront plus clairement par la 
suite, sont atteints selon 1'invention a i'aide d'un syst&me de controle 
d' equipements & distance, permettant Interconnexion entre au moins un serveur 
et au moins un equipement distant selon le protocole MQIsdp. 

Selon 1'invention, le systeme de controle associe h au moins un desdits 
equipements distants des moyens de radiocornmunication capable de traiter en 
interne un protocole de communication mettant en oeuvre des fonctions source de 
type API disponibles dans une plateforme logicielle (Open AT) permettant 
d'embarquer au moins une application, et lesdits moyens de radiocornmunication 
sont dotes d'un jeu de fonctions (API) specifiques permettant d'echanger des 
donnees avec au moins un serveur mettant en oeuvre ledit protocole MQIsdp, de 
fagon k permettre une interconnexion entre le ou lesdits serveurs et le ou lesdits 
equipements distants via lesdits moyens de radiocornmunication, ces derniers 
gerant egalement au moins une application entre le ou lesdits serveurs et le ou 
lesdits Equipements distants. 

Ainsi, il est possible de gerer entierement en interne, dans les moyens de 
radiocornmunication, et en particulier dans un module, F application de controle 
d'un ou plusieurs terminaux avec un serveur fonctionnant selon le protocole 
MQIsdp, sans que le terminal ne connaisse ce protocole. II n'y a rien & rajouter, du 
cote du terminal (ni materiel, tel que microprocesseur ou mEmoire, ni logiciel, tel 
qu'une application d6di£e). C'est le module qui gere ces operations, k I'aide des 
fonctions de 1'invention, et assure l'iiiterface avec le protocole MQIsdp. 

Selon un mode de realisation avantageux, lesdits moyens de 
radiocornmunication comprennent un module de radiocornmunication, regroupant 
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sur . meme substra. 1Wmb , e des moyens ^ fajtmit ^ 

Srr el T de base ' ^ ,ue ies moyens * «-*» 

API) e. ,a ou .esdites appHcations. C'es. ce module qui inSgre rappHcation e. .es 
ronctions source (API). 

De facon preferentieUe, ,esd itS moyens de radiocomn.unica.ion integren, 
edtf protocol MQIsdp sous la forme d .„ M dtf 8 

fonctions (API) spfcifiques. 

Au moins dans un premier mode de mise en oeuvre, Iesdi,s moyens de 
radrocummumcation gerent uniquemen. ,a signalisation d'un echange de donnees 
lesdnes donnees etan, transferees directemen. „■„ element distant vers „„' 
serveur, ou inversement. 

Dana un second mode de mise en ceuvre avantageux, qui est ce.ui 
** - *«* ~ * ^communication gerent 

stgnalrsaUon d'un echange de donnees e. ,e transfer, desdites donnees, ces 
demteres etan. temporairemem stockees dans au moins une memoire .ampon 

Dans ce eas, ,a tai.le de la ou desdites memoires tampon est 
avantageusement parametrable. 

Si les deux modes de realisation son. disponibles, on prevoit 
avamageusemen. que Pon foncionne dans ledit premier mode lorsque .a taine de 
la ou desdites memoires tampon vau. 0, e, dans ledit second mode sinon 

De facon avantageuse, .edit jeu de functions API specifies comprend 
aes fonctions permettant : 

- la connexion a un desdits serveurs ; 

- 1'envoi de messages ; 

- la reception de messages ; 

- configuration d'au moins unparametre. 

Pr6f€rentiellement, au moins certaines desdites fonctions (API) spdcifiques 
sont organises de facon a pouvoir assurer au moins deux operations et/ou agir sur 
au moins deux aspects distincts, en fonction d'un parametrage prddefini 

Cela permet d'optimiser le nombre de fonctions, tout en rendant possible 
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des evolutions. 

Dans un mode de realisation preTerentiel, ledit jeu de fonctions (API) 
comprend uniqueraent 12 fonctions. 

De facon avantageuse, ledit jeu de fonctions (API) specifiques comprend 
une fonction d'initialisation (mqisdp_init) retablissant des parametres par deTaut, 
et devant etre appelee au moins une fois avant 1'utilisation d'autres fonctions 
(API). 

Preferentiellement, ledit jeu de fonctions (API) specifiques comprend une 
fonction (mqisdp_resume) appelee lorsque une liaison IP a 6t6 etablie. 

Avantageusement, il comprend une fonction d'etablissement d'une 
connexion avec un desdits serveurs (mqisdp.connect), permettant de definir des 
parametres de ladite connexion, et une fonction de deconnexion 
(mqisdp_disconnect) de ladite connexion. 

Ladite fonction d'etablissement d'une connexion permet notamment, 
avantageusement, de selectionner un mode de transmission parmi au moins deux 
(GSM et GPRS). 

Ledit jeu de fonctions comprend encore, avantageusement, une fonction 
(mqisdp_publish) pour 1 'envoi d'un message vers un desdits serveurs. 

Pref6rentiellement, il comprend une fonction d'abonnement a un desdits 
serveurs (mqisdp.subscribe), et une fonction de desabonnement 
(mqisdp_unsubscribe) audit serveur. 

De facon avantageuse, ledit jeu de fonctions comprend au moins une 
fonction de demande d'information sur au moins un aspect d'une communication 
en cours, et par exemple au moins une des fonctions appartenant au groupe 
comprenant : 

- une fonction de demande du statut d'une connexion 
(mqisdp_getConStatus) ; 

- une fonction de demande du statut d'un message donne 
(mqisdp_getMsgStatus) ; 

- une fonction de demande de la taille actuelle d'une file d'attente 
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(mqisdp_ge.Q_ueueSize) ; 
- une fonction de demands de Pespace disponible dans une fll e 
d'attente (mqisdp_ge.AvailableSize). 
Preferentiellemen,, U comprend une foncdon de definition de la taille 
d'une He d'attente (mqisdp_setQueueSize). 

Invention concerne igalemen. les precedes de conttole d'equipements i 
d.s«a„ee, permettan, Pimerconuexion entre au moins u„ serveur et au moins un 
eqmpement distant selon le protocole MQIsdp. 

Un .el precede associe a au moins un desdits ^quipemenu distant* des 
moyens de radiocommunicaiion capabie de ttai.er en interne nn protoce.e de 
communicauon mettant en oeuvre des tactions source de type API dispones 
dans une p.atefonne .ogicielle (Open AT) permettant d'embarquer au moins une 
application, et met e» oeuvre, dans lesdits moyens de Communication un jeu 
de fonctions API specifies permettant d'echanger des donnees avec au moms 
un serveur mettant en ceuvre ledi. protocole MQIsdp, de facon a penned une 
mtemonnexion entre .e ou .esdits serveurs et .e ou lesdits elements distants via 
lesdtts moyens de radiocommunication, ces demiers gerant egalemen, au moins 
une appHcation entre !e ou tedits serveurs et le ou lesdits iquipements distant 

L-mvention concerne encore les dispositifs et les modules de 
md.ocommunica.iou mis en ceuvre dans uu systeme de conMle d'equipemenu a 
distance stel que decrit ci-dessus. 

L'iuvention concerne enfin igalement un jeu de fonctions (API) mis en 
oeuvre dans un sysSme de conWIe d-equ ip emen«s a distance, permettatt, 
d eehanger des donnees avec ait moms un serveur mettant en ceuvre ledi, 
protocole MQIsdp. 

D'autres caracteristiques e. avantages de Invention apparattrou. plus 
clatremen. a la lecture de .la description suivante d'un mode de realisation 
preferentiel de PinvenUon, donne a .toe de simple exe mpl e iHus.rn.if e . „ on 
hmiladf, et des dessins annexes, parmi lesquels : 

- la figure 1 iUustte un exemple de S ys.4me dans lequel Invention pen. 



etre mise eri oeuvre ; 

- la figure 2 est un exemple d' integration du protocole MQIsdp dans un 
module selon l'invention ; 

- la figure 3 est un synoptique simplifie d'un exemple d' envoi de 
message mettant en oeuvre 1' invention. 

1. Rappels sur le protocole MQIsdp (marque d^p osfe) 

Le protocole MQIsdp (« WebSphere MQ Integrator SCADA device 
protocol » en anglais) est une norme ouverte developpee par IBM et Arcom 
Control Systems (marques deposSes), visant k permettre les echanges de donnees 
(sous forme de messages) depuis des dispositifs distants (ou terminaux), 
generalement de bas de gamme et disposant de peu de puissance de traitement, 
vers un serveur, appele egalement par la suite « courtier » (« broker » en anglais) 
WebSphere MQ Integrator par TCP/IP, et inversement. 

MQIsdp (egalement appete par la suite Wavecom SCADA) est un 
protocole de transfert de donnees (message) base sur un modele de 
communication du type publier/souscrire, disponible libre de droit sur Internet. II 
peut etre decrit comme une simple couche de gestion de donnees agnostiques 
au-dessus du protocole TCP/IP pour assurer la gestion et les accuses de reception 
de message requis afin d'assurer la livraison fiable du message. 

Dans le module de communication publier/souscrire, les donnees sont 
echang6es entre un producteur/consommateur de donnees (le client) et un courtier 
de message (le serveur). Le courtier de messages peut etre considere comme un 
« hub » (nceud) de commutation multiprotocole au niveau du protocole de 
Implication qui re?oit des messages, les transforme, les reformate, etc. en d'autres 
structures en fonction d'un modele de donnees defini par l'utilisateur. 

Enfin, les messages 6ventuellement transformies peuvent etre erivoy6s par 
le courtier (publies) aux clients (dispositif de zone, ERP, SAP, Oracle, SQL, etc.) 
abonn6s en utilisant les cartes clients appropri£es. Le courtier peut, evidemment, 
publier egalement des messages ne provenant pas d'un client. 

Le courtier de messages gere tous les messages entrant et sortant d'une 



1er ctepot 

8 



rubnque. Un client publie des messages dans/avec une rubrique ou souscrit a des 
messages de/par une rubrique identifiant le flux de message du courtier de 
message vers lequel ou a partir duquel le message doit 6tre publie. 

La specification MQIsdp definit un ensemble de messages tres simple 
comprenant : « connect » (connecter), « disconnect » (deconnecter), « publish >> 
(publier), « subscribe » (abonner), « unsubscribe » (desabonner). 

2, principex He I'invfntinn 

2.1 ? Entrant** 

L'invention concerne done une nouvelle approche du controle 
d'eqmpements a distance, reposant notamment sur la mise en oeuvre d'un jeu de 
fonctions specifiques API permettant a une application externe de g€rer des 
echanges de donates entre un terminal distant et un serveur, via des moyens de 
^communication (par exemple un module de type Wismo (marque deposee)) 
sans que 1'application connaisse le protocole MQIsdp mis en oeuvre par le serveur 
Ce sont les moyens de radiocommunication qui gerent cet aspect, et par exemple 
les acquittements prevus dans le protocole MQIsdp. 

Les fonctions API sont des fonctions developpees en langage C qui 
permettent au module de gerer en interne, sous le controle d'une application elle- 
mSme interne au module, des echanges de donnees avec des serveurs mettant en 
oeuvre le protocole MQIsdp. 

La figure 1 illustre de facon simplified le principe de l'invention. 
L'objectif est de faire communiquer tout type de machines distantes, par exemples 
des instruments de mesure 11 avec une ou plusieurs applications hebergees par 
des serveurs 12, capables de recevoir des donnees 13 selon le protocole MQIsdp, 
et de les transformer, trailer ou transmettre. 

Selon l'invention, on associe aux terminaux (ou machines) distants 1 1 des 
moyens de radiocommunication 14, par exemple sous la forme d'un module 
Wismo (marque deposed), embarquant notamment les outils de developpement 
distribuds par le deposant sous la marque « Muse platform ». 

2.2 Notinr, de module 



Pour m^moire, on rappelle que la plupart des dispositifs de 
radiocommunication comprennent, de fagon classique, un ensemble de 
composants electroniques implantSs sur un circuit imprim6. Ces diff&rents 
composants ont pour but d'assurer les differentes fonctions necessaires, depuis la 
reception dun signal RF jusqu'a la generation d f un signal audible (dans ie cas d'un 
radio-telephone), et inversement. Certaines de ces fonctions sont analogiques, et 
d'autres numeriques. 

La fabrication de ces dispositifs de radiocommunication est un sujet de 
recherche important* En effet, on vise au moins trois objectifs difficiles a 
concilier : miniaturiser les dispositifs, augmenter les fonctionnalit6s et simplifier 
le montage. On sait notamment que l'implantation des differents composants sur le 
circuit imprime est une operation relativement complexe, de nombreux 
composants devant etre mis en place sur une surface de plus en plus restreinte, du 
fait des exigences de miniaturisation. 

La conception de ces systemes est done complexe, puisqu'elle necessite en 
outre d'associer des composants divers, souvent de sources multiples, qu'il faut 
faire fonctionner ensemble, en respectant les specificites de chacun. Par ailleurs, 
apres le moritage de Tensemble des composants, des phases de calibration et de 
tests, souvent longues et complexes, sont necessaires pour garantir le bon 
fonctionnement du dispositif . 

Enfin, malgre la reduction de la taille de certains composants, Tensemble 
occupe une certaine surface, qu'il est difficile de r6duire. 

Le titulaire de la presente demande de brevet a propose une approche 
palliant un certain nombre de ces inconvSnients, consistant k regrouper dans un 
module unique, toutes ou au moins la plupart, des fonctions d ! un dispositif de 
radiocommunication num£rique. 

Un tel module se presente sous la forme d'un boltier unique et compact, 
pref6rentiellement blind6, que les fabricants de dispositifs peuvent implanter 
directement, sans devoir prendre en compte une multitude de composants. 
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Ce module (encote appCe parfois <( 
d u regroupemen. de p.usiems composanB sur ™ 

r essenueis " cessaires « Lja r* 

Uti,i »" d « «™ radio-fleeces „ nV . do , 
drapes comptexes de concepdon d u desta, « d< . , „ y P ' US 

„.,.- . . on™ design, et de valtdanon de celui-ci. II suffil 

de reserver la place n&essaire au module. 

Un ,el module perme, done d-integrer facilemem, rapidemen. et de f, 
opumisee ,-ensemble des composants dans des ta— JT^ fc 

Pax adleurs, eelui-ci r e gr0 „pant tomes Ies " 
ete eoueues comme un tout, ,es p ro blemes de calibradon et de tests „e . 

Ainsi, Ies modules diffuse par le Utll]aire 

(« software ») sur la olunart ,w 4 i0 S lc *el 

plupart des reseaux sur lesquels ils pourront 6tre utili^ 

===~======S~ 

• On eonnaS, de j4 des modules embanjuant des fonctions API Le document 
o*ergeant et executant un logicieI ^ ^ ^ ^ ^ 

radtocommunlcauon, .edl, .ogiciei « compxenan, des moyens d^ l 

elon cette technique, ,e module de ^communication J^ZL 
n outte au moins un logicie, Cient, d it iogicie! cben, emb^ue. En " 
■ogtcte, Cent emba, q ue et ,e ,o gi eie, principal compel, de m ^ 
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permettant au logiciel client embarque de jouer au moins un des deux roles 
suivants : 

le role d'un logiciel client de pilotage, envoyant des commandes de 
pilotage au logiciel principal, et recevant du logiciel principal des 
reponses, resultant de l'ex6cution de certaines des commandes de 
pilotage ; 

le role d'un logiciel client de supervision, gerant l'ex£cution de 
commandes de pilotage envoySes par un logiciel client de pilotage, 
dit logiciel client externe, heberge et execute par un equipement tiers 
cooperant avec le module de radiocommunication. 
Le principe general de Tinvention consiste done a heberger sur le 
module de radiocommunication au moins un logiciel client pouvant jouer le 
role d'un logiciel client de pilotage et/ou le r61e d r un logiciel client de 
supervision. 

On pourra se referer h ce document pour plus de details, si 

n^cessaire. 

2.4 Nouvelles fonctions API 

Le module 14 est done capable, selon 1' invention, de gerer des fonctions 
API, et eri nombre reduit, permettant un dialogue simple et efficace. avec un 
terminal, sous le controle d'une application interne. II assure la transformation au 
format MQIsdp, et gere remission et la reception de donnees 15 selon ce 
protocole, de fa§on transparente pour 1* application et le terminal. 

L'echange de donnees peut ainsi se faire de fa9on hertzienne 16, par 
exemple selon le standard GSM ou GPRS. Vu du serveur 12, les informations 
sont au format MQIsdp. Pour les tenninaux 1 1, il ri'est pas n6cessaire de connaltre 
ce protocole, ni de mettre en oeuvre des moyens particuliers, tels qu'un 
microprocesseur et des memoires, et une application d€di6e. 

Comme on le verra par la suite, les fonctions proposees peuvent etre en 
nombre limits, tout en permettant des evolutions. 

Les donnees transitent par le module 14. Elles sont alors stock^es 
temporairement dans des buffers (memoires tampon), dont la taille est 
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configurable en fonction des besoins. 

La figure 2 illustre un exemple simplifie d' architecture logicielle pouvant 
Stre mise en oeuvre dans le module 14. 

Un tel module 14 comprend generalement : 

- une couche logicielle de base 21 (« Wavecom Core Software ») ; 

- une bibliotheque Open AT 22 (« Open AT Library ») ; 

- une bibliotheque ADL 23 (« ADL Library ») ; 

- une bibliotheque TCP/IP 24 (« TCP/IP Library ») ; 

- une couche applicative 25 (« Open AT Application »). 

Selon Invention, on pr6voit done en outre une bibliotheque 26 de 
commandes specifies (« Wavecom SCADA Protocol Library ») pour 
communiquer selon le protocole MQIsdp, qui se place au dessus de la 
bibliotheque TCP/IP 24. 

L'interface propos6e comprend, dans cette bibliotheque 26, seulement 12 
fonctions API, permettant d'exploiter entierement le protocole MQIsdp. Ces 
fonctxons sont detaillees par la suite. 

Optionnellement, les commandes AT 27 s'adressent, selon les cas a la 
couche de base 21 . a la bibliotheque TCP/IP 24 ou a la bibliotheque SCADA 26 
Le module pent en effetegalement gerer des commandes AT, pour assurer les 
memes operations d'interface. 

~ Option de>ail¥.e d'u n mode de, galigatian ^e fonction* apt 

On decrit ci-apres les fonctions API pouvant etre utilisees pour piloter le 
protocole Wavecom SCADA 26. 
2J. Document s connex** 

En cas de besoin, on pourra se x6f6rex a : 

[I] la fiche "WepSphere MQ Integrator SCADA Device Protocol" figurant 
a 1'annexe B du manuel de reference "IBM WebSphere MQ Integrator 
Programming Guide" disponible a l'adresse suivante : 
http://pubhtp.boulder.ibm.com/epubs/odf/bipval04.pdf 

[2] Wavecom AT Commands Interface Guide 
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Reference : WMJSWJ3ATJDFSJ)01 - revision : 009 ou suivantes. 

Ce document decrit les commandes AT prises en charge par le 
produit Wavecom permettant de gerer les evenements ou services GSM 
connexes. 

5 [3] AT Command Interface for TCP/IP 

Revision : 1.7 

Ce document decrit les parametres et ie jeu de commandes AT 
permettant la configuration et le pilotage de la superposition TCP/IP et 
des protocoles disponibles sur les produits Wavecom. 
10 [4] WebSphere MQ Integrator Programming Guide (Version 2. 1), Annexe 

B. 

[5] Edjlb-30x Interface Specification 
[6] ADL User Guide 
3.2 Abreviations et definitions 
15 32.1. Abreviations 

MQIsdp Protocole de dispositif MQ Integrator SCADA 
SCADA Supervisory Control and Data Acquisition (Dispositif de 

surveillance et acquisition des donnees) 
APN Access Point Name (Nom de point d'acces) 

20 AT Attention 

DNS Domain Name Systeme (Syst&me de noms de domaine) 

ISP Internet Service Provider (Fournisseur de services sur Internet) 

ME Mobile Equipment (Materiel mobile) 

MS Mobile station (Station mobile) 

25 QoS Quality of Service (Quality de service) 

33 architecture 

La bibliotheque MQIsdp est construite au-dessus de la bibliotheque ADL 
de Wavecom etde la bibliotheque TCP/IP. Des applications imbriquees utilisant 
la bibliotheque MQIsdp doivent done 6tre mises en oeuvre & l ! aide de la 
30 bibliotheque ADL (plut6t qu'avec la couche API Open AT standard directement). 
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La figure 2 deja commence presente cette architecture 
Le logicie! « MQIsdp for Open AT » selon ce mode de realisation contient 
les Elements suivants : 

• Une bibliotheque logicielle conforme a ADL (wmmqisdp.lib) 

• Un fichier d'en-tete (mqisdp.h) deTmissant 1'API MQIsdp 

• Quelques echantillons de code source 

Une application imbriquee utilisant la bibliotheque MQIsdp doit 8tre reliee a 
wmadi.lib et edlib.lib (ces bibliotheques sont incluses dans le logiciel « MQIsdp 
for Open AT » foumi avec le module). 

En raison des ressources de memoire limitees dans 1'environnement Open 
AT, d est unportan, de connate exactement la quantite de memoire utilises par 
nne btbhotheque on nn processus donne. La bibliotheque MQIsdp est done 
centree sur une gestion precise de la memoire. 

Toutes les fonctions de commande MQIsdp dans Implication API 
(connect (connecter), publish (publier), subscribe (abonner), unsubscribe 
(desabonner) e, disconnect (deconnecter)) sont asynchrones (les fonctions 
renvoien. immediatemen. et la sortie finale des operations associees es, signalee 
parrappel). 

II pent exister 4 tout moment des messages MQIsdp que la bibliotheque a 
accep,6, mais qui n'on, pas <S« envoy* an courtier, qui n'ont pas encore recu 
dWes de reception de la par. dn courtier on qui n'ont pas encore e.e distribues 
a .'application imbriquee (le client). Tons cea messages en suspens son. conserves 
dans la file d'attente par la bibliotheque. La bMotheque ne pen. pas garandr ,a 
ladle maximale de cette file d'attenfc ear elle depend de la taille des donneea 4 
ovoyer/recevoir, de la frequence d'envoi/rfcepdon et de la largeur de bands de la 
connexion TCP/IP. 

Un controle complet de la taille maximale de la file d'attente est fourni a 
rapphcanon client par un ensemble de fonctions API permettant de definir et de 
connaitre la taille maximale de la file d'attente et de demander la taille actuelle de 
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la file d'attente. 

Dans certains cas (taux eleve d'erreurs de transmission entrainant des 
coupures frSquentes de la connexion), une taille plus elev^e de la file d'attente est 
necessaire car la bibliotheque doit mettre les messages en memoire tampon 
jusqu'St ce que la communication soit retablie. 
3.5 remarques complSmentaires 

3.5 J Une seule connexion MQIsdp & lafois 

La bibliotheque MQIsdp depend de la bibliotheque TCP/IP, qui est limitee 
k une connexion a la fois. La bibliotheque MQIsdp est done limitee & une seule 
connexion MQIsdp a la fois. 

3.52 Taille de message MQIsdp limitde 

La bibliothfeque peut etre con9ue pour envoyer et recevoir des messages 
MQIsdp avec une taille maximale de 65 535 octets (y compris des en-tetes fixes et 
variables). 

La specification MQIsdp autorise des longueurs de charge utile maximales 
de 268 435 455 octets, ce qui signifie qu'un courtier peut potentiellement envoyer 
un message superieur a 65 535 octets (ou la taille limite de la file d'attente) au 
client. Dans ce cas, le client est prevenu par un programme de traitement que la 
file d'attente est saturee (et le message n'est pas re?u). De meme, si le client essaie 
d'envoyer des messages alors que la file d'attente est saturee, une indication 
signale que la file d'attente est saturee et que 1'envoi du message n'a pas et6 
accepte. 

II est ainsi aise de gerer la saturation eventuelle d'une file d'attente et/ou la 
transmission d'un message de taille trop importante. 

Comme deja mention^, on peut egalement, dans certains modes de 
realisation, prevoir des transferts directs entre un terminal et le serveur, le module 
ne gerant que la signalisation, 

3.6 API MQIsdp 

Les sections suivantes donnent une description detaillee de toiites les 
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fonctions de 1'API MQIsdp. 

3.6.1 Erttgte zsgmi 

L'en-tete des fonctions MQIsdp est : Mqisdp.h 

3.6.2 Fnnrfionm^p i„j t 

el.e do,, etre appe,ee an moins une fofe ^ ^ ^ ^ ^ 

La foncnon -taW* (o„ reioi.ia.ise) les valenrs par defau. des parages 

1 s T7 T T optiom de connexion - EUe r4sk la taiu * de * «■ * 

" S ' ' a f ° nC,IOn ™ connexion est active, el.e 

deconnecte brotalemen, et supprime tons .es messages en file d'a<,e„,e 

La bibUotheque TCP/IP DOrr etre inidaii.ee avan, KninaJiaation de la 
bibhotheque MQIsdp. 

a - Profnryp p 

U8 m q i sd p_i„l t (mq i sdp _ linkHdlr _ f linMandler) ; 
b - Paran^trec 

- LinkHandlerj 

Le paratnetre Ln*Han<Uer es. appele par la biblio.beqne lorsqn'une iiaison 
"™° abSeDtt °" >a «aison IP es. presente mai s pas 

n&essane. I, pem.ee done a location Cien, de confer prfcisemen, ,a iiaison 

Le type snivan. est uHlis6 ponr Ie parametre LinkHandler : 

typedef void (»mqisdp_IinlcHdlr_f)(n8 Event) ; 
Le paramStre Event peut etre : 

- MQISDPJLINK_NEE£)ED si nne iiaison IP est necessaire, mais 
qu'aucune liaison n'est etablie. 

- MQISDP_LINK_CLOSABLE si nne . liaison IP n'es. p Ius 
necessaire mais qu'une liaison est encore etablie 

Lappelan. pen. soi. foumir „n parametre LinkHandler conforme an 
prototype c.-dessons, soi, utilise. NULL. Si le paramete LinkHandler es, NULL, 
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la bibliothfeque assurera le controle de la liaison IP et essaiera de (re)etablir une 
liaison IP lorsqu'l est necessaire et de fermer la liaison lorsqu'elle n'est plus 
necessaire. Dan ce cas, la composition, les parametres PPP et/ou CPRS doivent 
avoir 6t6 actives par VAPI TCP/IP avant la connexion k un courtier de message. 
c - Valeurs de retour 

MQISDP_OK : L ! initialisation (ou la reinitialisation) a about! 
3.6.3 - Fonction mqisdp resume 

Cette fonction doit etre appetee lorsqu'une liaison IP a 6te etablie apres que 
la bibliotheque MQIsdp a indique qu'une liaison IP etait necessaire 
(MQISDPJLINKJNTEEDED) par I'intermediaire du programme de traitement de 
liaison. 

a - Prototype 

void mqisdp_resume () ; 
b •- Parametres 
Aucun. 

c - Valeurs de retour 
Aucune. 

3. 6 A - Fonction mqisdp connect 

Cette fonction est utilisee pour etablir une connexion avec un courtier de 
message. La fonction est asynchrone et le r^sultat final de l'operation est signale 
par une fonction de rappel (ConCtrlHandler). Si une connexion est deja active 
lbrsque cette fonction est appelee, une erreur est renvoy6e. 

a - Prototyp e 

u8 mqisdp__connect ( 
mqisdp_connectionParams__t* Connect ionParams, 
mqisdp__connectionOptions_t Connect ionOptions , 
mqisdp_connectionWill_t ConnectionWill , 
mqisdp_conCtrlHdlr_f ConCtrlHandler, 
mqisdp_msgCtrlHdlr_f MsgCtrlHandler, 
mqisdp_subCtrlHdlr_£ SubCtrlHandler , 
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mqisdp_msgHdlr_f MsgHandler, 
); 

b - Parametria 

* ConnectionParams : Pointeur vers une structure contenant les 

informations de connexion de base. Le pointeur ne doit PAS etre avoir une valeur 
nulle ; la structure utilise le type suivant : 

typedef struct 

{ 

// Client id with a maximum length of 29 
ascii*Clientid; 

//Address of message broker (ip or name, according to the settings of the 
TCP/IP stack) 

ascii*BrokerAddress; 
} 

mqisdp_connectionParams_t; 
* ConnectionOptions : 

Pointeur vers une structure contenant les informations de connexion 
facultatives utilisant le type suivant : 
typedef struct 
{ 

//Port on which to connect to the message broker 
ul6Port;//default: 1883 
//Keep Alive Timer; G=no keep-alive messages 
ul6 KeepAliveTimer; // default :0 

//Retry count; how many times a connection attempt or message sending 

should be retried 

u 1 6 Retry Count://default : 1 0 

//Retry delay : how long the library should at least wait before retrying (in 
seconds) 
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ul6RetrayDelay;//default : 10 

//Clean flag : indicates whether each a client, connection should be 
performed or not! 

bool nCleanConnection://default : TRUE 
} 

mqisdp_connectionOptions__t; 

Le pointeur peut avoir la valeur nulle (NULL). Dans ce cas, les valeurs par 
defaut sont utilisees . 

* Connection Will : 

Pointeur vers une structure contenant les informations sur le will de 
connexion. La structure utilise le type suivant : 
typedef struct 
{ 

//Quality of service 

u8 Qos; 

bool Retain; 

ascii* Topic; 

ul8 PayloadLength; 

u8 Pay load [3]; 

} 

mqisdp_connectionwill_t; 

Le pointeur peut avoir la valeur nulle (NULL). Dans ce cas les valeurs par 
defaut sont utilisees. 

* ConCtrlHandler : 

Programme de traitement de controle de connexion par lequel le client regoit 
des 6venements relatifs a la connexion. Le programme de traitement utilise le type 
suivant : 

typedef void (*mqisdp_conCtrlHdlr_f) (u8 Event, u8 ErrorCode); 
Le parametre Event peut avoir les valeurs suivantes : 
MQISDP_CON_OPEN : La connexion au courtier est prete. 
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MQISDP_CON_ERR : La connexion Q>a pas pu atre ^ ^ ^ 

d'une erreur ou s'est interrompue (la 
bibliotheque peut tenter de la retablir) 
MQISDP_CON_ACCEPTED : La connexion mqisdp avec le courtier 

est prete. 

MQISDP_CON_REFUSED : La connexion mqisdp avec le courtier a &6 

refusSe. 

MQISDP_CON_IN_(i_FULL: Des donnees entrantes ont 6t6 

refusees car la file d'attente est saturee. 
MQISDP_CON_BROKEN : La connexion mqisdp avec le courtier s'est 

interrompue et toutes les tentatives de 

reconnexion ont echoue. 
MQISDP_CON_CLOSED : La connexion avec le courtier a ete fermee 

(proprement). 

MQISDP_CON_DISCONNECTED : La connexion mqisdp avec le courtier 

a 6t6 fermee (proprement). 
Dans un scenario normal (depuis la connexion jusqu'a la deconnexion), le 
programme de traitement de contr61e recoit la sequence suivante d'evenements : 
MQISDP_CON_OPEN 
MQISDP_CON_ACCEPTED 
MQISDP_CON_CLOSED 
MQISDP_CON_DISCON2^CTED 

L'envoi de messages n'est possible que lorsque la connexion MQIsdp est 
prete (c'est-a-dire lorsque la fonction MQISDP_CON_ACCEPTED a ete recue et 
qu'aucune deconnexion n'a eu lieu ou n'a 6t6 effectuee. 

Le parametre Errorcode . n'est utilise^ que si le parametre Event est 
MQISDP.CON_REFUSEb. Dans ce cas, le code d'erreur peut prendre les formes 
suivantes : 

MQISDP^ERR_PROTOCOL_VERSION_ERROR : Connexion refusee en 

raison d'une version de protocole non prise 
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en charge. 

MQISDP_ERR_INDENTIFIER_REJECTED : Connexion refusee en 

raison d'un rejet de l'identificateur. 

MQISDP_ERR_BROKER_UNAVAILABLE : Connexion refusee en 
5 raison de l'indisponibilitS du courtier. 

MQISDP_TCPIP_UNAVABLABLE : La connexion n'a pas pu Stre etablie 

en raison d'une erreur sur la liaison TCP/IP. 

MQISDP_DNS_PROBLEM : La connexion n'apas pu 6tre etablie en raison 

d'une erreur SND. 

10 MQISDP_ERR_S OCKET_ERROR : La connexion n'a pas pu etre etablie 

en raison d'une erreur de socket. 

* MsgCtrlHandler : 

Programme de traitement de contrSle des messages par lequel le client 
recoit des ev6nements relatifs a l'envoi du message. Le programme de traitement 
15 utilise le type suivant : 

typedef void (*mqisdp_msgCtrlHdlr_f) (u8 Event, ul6Msgid); 
Le param&tre Event peut prendre les formes suivantes : 
MQISDP_MSG_DELIVERED : Le message a 6t6 envoye/distribue 

(conformement au parametre Qos). 
20 MQISDPJVISGJDISCARDED : Le message a ete supprime (echec de 

toutes les tentatives). 
Le parametre Msgid contient l'id du message concerne" par Fevenement. 
L'id d'un message est renvoy6 lors de l'ufilisation de Tune des fonctions suivantes : 
mqisdp_publish, mqisdp_subscribe, mqisdp_unsubscribe, mqisdp_disconnect. 
25 * SubCtrlHandler : 

Programme de traitement de contrSle d'abonnement par lequel (s'il n'a pas 
la valeur nulle (NULL)), le client recoit des 6venements relatifs a 1'accuse de 
reception de l'abonnement. Si le programme de traitement a la valeur NULL, les 
tenements dlaccuse" de reception de l'abonnement sont transfers au programme 
30 de traitement de contrdle des messages. 
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En revanche, les informations relatives au niveau accord* de qualite de 

service pour chacune des rubriques souscrites ne peuvent pas etre recues par 

hntenne-diairedu programme de traitement de controle des messages. ' 

Le programme de traitement de contr61e d'abonnement utilise le type 
suivant : JV 

typedef void (*mqisdp_subCtrIHdlr_f) ( 
u8 Event, 

mqisdp_subscriptionParams_t* SubscriptionAray 

); 

Le parametre Event peut prendre les formes suivantes • 
MQISDP_MSG_DELIVERED : Le message a ete envoye/distribu, 

(conformement au parametre Qos) 
MQISDP_MSG_DISCARDED : L e m essage a « supp™*'^ de 

toutes les tentatives). 
Le parametre Msgid contient 1'id du message concern* par IVSvenement Lid 
du message est renvoye lors de Utilisation de la fonction mqisdp subscribe 

Le parametre SubscriptionArray est un tableau d'elements de la structure 
suivante : 

Typedef struct 

{ 

ascii* Topic, 
u8 QoS 
} 

mqisdp_subscriptionParams_t; 

Le tableau conserve des informations sur le niveau accord* de qualite" de 
service pour chacune des rubriques souscrites. 
* MsgHandler : 

Programme de traitement de message par lequel le client recoit des 
messages du courtier. Le programme de traitement utilise le type suivant : 
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Typedef bool (*mqisdp_msgHdlrJO ( 
Ascii * Topic, 
Bool Retain, 
Bool Duplicate, 
mqisdp_qos_e QoS, 
Mqisdp_messageid msgid, 
U16 PayloadLength, 
U8 Payload [1] 

); 

Si le programme de traitement de message renvoie la valeur True, la 
biblioth&que supprime le parametre Payload. Sinon, le client doit prendre en 
charge la gestion de la charge utile. 

Le parametre mqisdp_messageid est defini comme suit : 

Typedef u 1 6 mqisdp_messageid; 
Le parametre mqisdp_qos__e est defini comme suit : 
Typedef enum 

{ 

MQISDP__QOSJ), 
MQISDP_QOS_l, 
MQISDP_QOS_2, 
} mqisdp_qos_e 

c - Valeurs de retour 

MQISDP_OK: Succes 

MQISDP_ERR_Q_FULL : File d'attente des messages k destination de 

Texterieur trop petite/saturee. 

MQISDP_ERR_ALREADY_CONNECTED : Dejh connecte h un courtier. 

. Commencez par deconnecter. 

MQISDP_ERR__DISCONNECT_PENDING 

//Une d£connexion est en suspens. Attente de 
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la ddconnexion. 

MQISDP_ERR_PARAM_CLIENT_ID : Le parage client id est illegal 
MQISDP_ERR_PARAM_CLIENT_ID_TOO_BIG : Le parametre 

client_id est trop long (maximum 23 

caracteres). 

MQISDP_ERR_PARAM_TOPIC : Le paramette topic est illegal 
MQISDP.ERRJ.ARAM.TOHCJOO^JO : Le paramette topie eat trap 

long (maximum 32 767 caracteres) 
MQISDP_ERR_PARAM_DATA_LENGTH : Le parametre 

payloadjength est illegal 
MQISDP_ERR_PARAM_DATA_TOO_BIG : Le parametre payload est 

trop long (maximum 65 535 caracteres, y 

compris les en-tetes). 
MQISDP_ERR_PARAM_QOS : Le paramette qos est incorrect 
MQISDP_PIN_NOT_ J ENTERED : Une erreur du a „„ code PIN manquaut 

s'est produite. 
3.6 J Fonction mqisdp_disconnect 

Cette fonction est utilisee pour fermer la connexion mqisdp. Si elle est 
appelee alors qu'une autre deconnexion est en suspens, une erreur est renvoyee. 
a - Prototyp e 

u8 mqisdp__dis connect ( 
mqisdp_messageid* Msgld, 
bool ImmediateDisconnect 
); 

b - Parametre 

* Msgid : 

En retour, conserve l'id attribue au message de deconnexion. 

* ImmediateDisconnect : 

Cet indicateur determine si la d6connexion doit etre immediatement forcee 
(si 1'indicateur a la valeur True (vrai)) ou si la deconnexion pent attendre que tous 
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les messages actuellement en file d'attente soient distribues (ou supprim^s). Si la 
deconnexion peut attendre, la bibliothfeque n'accepte pas de nouveaux messages 
du courtier. 

c - Valeurs de retour 
5 MQISDP_OK : Succes. 

MQISDP JBRR_J)IS CONNECT JPENDING : Une deconnexion est deja 

en suspens. 

3.6.6 Fonction mqisdp publish 

Cette fonction est utilis£e pour publier un message MQIsdp au courtier de 
10 message. Cette operation ne peut Stre effectuee que si une connexion est dej& 

active. 

a - Prototyp e 

u8 mqisdp__publish ( 
• mqisdp_messageld* Msgld, 
15 ascii * Topic, 

mqi s dp__qo s__e Qo s , 
bool Retain 
u!8 PayloadLength, 
u8 Payload [1] 
20 ) 

b - Payametres 
* Msgid : 

En retour, conserve Tid attribue au message de deconnexion. 
c - Valeurs de retour 
25 MQISDP JDK : Succes. 

MQISDP JERR_CONNECTION_INVALID : La connexion au courtier 

n'est pas prete. 

MQISDPJBRJ3JFULL : La file d'attente des messages a destination de 

Text&ieur est trop petite/satur€e. 
30 MQISDP JERR_DIS CONNECTJPENDING : Une deconnexion est en 
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suspens. Impossible d'accepter des 
messages. 

MQISDP_ERR_PARAM_TOPIC : Le paramte <opic es. iUegal 
MQISDP_ERR.PARAM_TOHC.TOO JBIG : Le parang topic es. ttop 

long (maximum 32 767 caracteres) 
MQISDP.ERR.PARAM.DATA.LENGTH : Le parage 

payloadjength est illegal. 

MQISDPJERR PARAM DATA TOO nrr . t , 

~ Ai - 1 °°-BK3 : Le parametre payload est 

trop long (maximum 65 535 caracteres, y 

compris les en-t6tes). 

MQISDP.ERR_PARAM.QOS : Le paramette qos est incorrect 

3.6.7 - Fonction mgi*J p subxr.riho 

Cette ronctton es. utUisee pour envoyer an message a'abomtemen. au 
courner de message. Cette operatiou „e peu. etre effectuee que si une conrtexioa 
est dej^ active. 

a - Protoryp ^ 

u8 mqisdp_subscribe 
{ 

mqisdp_messageld* Msgld, 

ul6 NoOf Subscript ions, 

mqisdp__subscriptionParams_t* 

SubscriptionArray 

} 

b - Parametric 

* Msgid : 

En retour, conserve I'id attribue au message de deconnexion 

* NoOfSubscriptions : 

Nombre d'&ements du parametre SubscripaonArray. 

* SubscriptionArray : 

Tableau d'elements de.la structure suivante : 
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* Typedef struct 
{ 

ascii * Topic, 

u8QoS 

} 

mqisdp_subscriptionParams__t; 
c - Valeurs de retour 
MQISDP_OK : Succes. 

MQISDP_ERR^CONNECTIONJNVALID : La connexion au courtier 

n'est pas prete. 

MQISDP_ERR_Q_FULL : La file d'attente des messages k destination de 

l'exterieur est trop petite/saturee. 

MQISDP_ERR_DISCONNECT_PENDING : //Une disconnexion est en 

suspens. Impossible d'accepter des 
messages. 

MQISDPJSRRJPARAMJTOPIC : Le paramfetre topic est illegal. 
MQISDP^ERR^PARAM^TOPIC^T003IG : Le parametre topic est trop 

long (maximum 32 767 caracteres). 
MQISDP_ERR_PARAM__QOS : Le paramfetre qos est incorrect. 
3.6.8 - Fonction rnqisdp unsubscribe 

Cette fonction est utilisee pour publier un message de desabonnement au 
courtier de message. Cette operation ne peut etre effectu^e que si une connexion 
est deja active. 

a - Prototyp e 

u8 mqisdp_unsubscribe 
{ 

mqisdp_messageld* Msgld, 

ul6 NoOfUnsubscriptions, 

ascii * UnsubscriptionTopicAray 

} 
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b - Parametral 

* Msgid : 

En retour, conserve 1'id attribue au message de deconnexion. 

* NoOfUnsubscriptions : 

Nombre d'elements du parametre UnsubscriptionArray. 

* UnsubscriptionArray : 

Tableau des rubriques concerned par le desabonnement. 
c - Valeurs tfe iv»tr .n r 

MQISDP_OK : Succes. 

MQISDP_ERR_cONNECTION_INVALID : La connexion au courtier 

n'estpasprete. 

MQISDP_ERR_Q_FULL : La file d'attente des messages a destination de 

I'exterieur est trop petite/saturee. 

MQISDP_ERR_DISCONNECT.PENDING : //Une deconnexion est en 

suspens. Impossible d'accepter des 
messages. 

MQISDP_ERR_ PA RAM_TOPIC : Le parametre topic est illegal 
MQISDP_ERR_PARAM_TOPIC_TOO_BIG : Le parametre topic est trop 

long (maximum 32 767 caracteres). 
3.6.9 -Fonrtion mqisdp ?/ >tr™<n nUn 

Cette fonction est utilised pour demander le statut de la connexion, 
a - Profptypp 

u8 mqisdp_getConStatus () ; 
b - Parametres 

Aucun 
C - Valenrs ri* r ^,-. r 

MQISDP.CONNECTING : Si une connexion est en cours d^tablissement 

(pas encore prSte a accepter des 
messages). 

MQISDP.CONNECTED : Si une connexion est active (e. prete » accepter 
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des messages). 

MQISDP_DISCONNECTED : Aucune connection n'est active. 
3.6 JO -Fonction mqisdp g etMsgStatus 

Cette fonction est utilis€e pour demander le statut d'un message donn€. 
a - Prototype 

tj8 mqisdp_getMsgStatus (mqisdp_messageid* Msgld) ; 
b - Parametres 

L'identifiant (id) du message. 
c - Valeurs de retour 

MQISDP_IN_QUEUE : Le message est dans la file d'attente a destination 

de l'exterieur (n'a pas encore ete envoye). 

MQISDP_SENDING : Le message est maintenant en cours Renvoi (par 

TCP/IP). 

MQISDP JDNfJPROGRESS : Le message a ete envoye par TCP/IP mais 

• aucun accuse de reception n r a encore ete 
regu. 

MQISDPJNTOJSUCHJMSG : Le message n'existe pas (plus). Soit il n'a 

jamais ete envoye, soit il a ete envoys et 

• regu (accuse de reception de la part du 
courtier). 

3.6 J 1 - Fonction mqisdp setOueueSize 

Cette fonction est utilisee pour definir la taille de la file d'attente* La taille 
de la file d'attente peut Stre modifi<Se a tout moment, mais si la nouvelle taille est 
trop petite pour contenir les messages actuels, une erreur est renvoyee. 

a - Prototype 

u8 mqisdp_setQueueSize (ul6 QueueSize) ; 
b - Paramfetres 

QueueSize : Taille de la file d'attente en octets. 
c - Valeurs de retour 
MQISDP_OK : Succes, 
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MQISDP_ERR_Q_FULL : La taUle de la file d'attente ne peut pas etre 

deTinie. Le parametre est sans doute trop 
petit pour les messages actuellement en 
file d'attente. 

3.6.12 Fnnrtinr, nsfirJp g etOueu.fi.Vr* 

Cette fonction est utilisee pour connaltre la taille actuelle de la file 
d'attente. 

a - Prototyp e 

ul6 mqisdp_get QueueSize () ; 
b - Parametral 

Aucun. 

c - Valeurs de retonr 

La taille actuelle de la file d'attente est renvoyee (en octets). 
3.6.13 - Fonction mgisHp oetAvailnhlrSir* 

Cette fonction est utilisee pour connaitre la quantit6 d'espace disponible 
dans la file d'attente. 
a - Prototype 

ul6 mqisdp_getAvailableSize (); 
b - Paramefrag 

Aucun. 

c -Valeurs de retour 

L'espace actuellement disponible dans la file d'attente est renvoye (en 

octets). 

Exempli de mise e>n oeiivrp. 

La figure 3 pr6sente un exemple d'envoi de message, a 1'aide des fonction 
API de l'invention. 

Les etapes sont les suivantes : 

- initialisation 31 : . fonction « mqisdp_init() ; 

- parametrage 32 de la dimension de la file d'attente : fonction 
mqisdp_setqueuesize Q ; 
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connexion TCP/IP 33 (ouverture d'une session GPRS) ; 

si la connexion n'est pas bonne (34) : message d'erreur 35 ; 

sinon : connexion 36 au « courtier » : fonction mqisdp_connect 0 ; 

si la connexion n'est pas bonne (37) : message d'erreur 35 ; 

sinon : envoi du message 38 : fonction mqisdp_publish() ; 

si dSconnexion 39, alors fin 310 ; 

sinon message d'erreur 35. 
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REVENDICATIONS 

1. Systeme de contr61e d'equipements a distance, permettant 1' interconnexion 
entre au moins un serveur et au moins un equipement distant selon le protocole 
MQIsdp, 

caracterise en ce qu'il associe a au moms un desdits equipements di Sl an,s des 
moyens de radicKommunication capable de trailer en interne un protocole de 
communication mettan, cn oeuvre des fonctions source de type API disponibles 
dans une p.ateforme logicielie (Open AT) permettant d'embarquer au moins une 
application, 

et en ce que lesdits moyens de radiocommunication sont dote* d'un jeu de 
fonctions (API) specifies permettant d'echanger des donnees avec au moins un 
serveur mettant en oeuvre ledit protocole MQIsdp, 

de facon a permettre une interconnexion entre le ou lesdits serveurs et le ou lesdits 
equipements distants via lesdits moyens de radiocommunication, ces derniers 
gerant egalement au moins une application entre le ou lesdits serveurs et le ou 
lesdits equipements distants. 

2. Systeme de contr6Ie d'equipements a distance selon la revendication 1 
caracterise en ce que lesdits moyens de radiocommunication comprennent un 
module de radiocommunication, regroupant sur un meme subset Fensemble des 
moyens de traitement de donnees radio-frequence et bande de base, ainsi que les 
moyens de gestion desdites fonctions (API) et la ou Iesdites applications. 

3. Systeme de controle d'equipements a distance selon Tune quelconque des 
revendications 1 et 2, caracterise en ce que lesdits moyens de radiocommunication 
mtegrent ledit protocole MQIsdp sous la forme d'une librairie, definissant ledit 
jeu de fonctions (API) specifiques. 

4. Systeme de controle d'equipements a distance selon 1'une quelconque des 
revendications 1 a 3, caracterise en ce que, au moins dans un premier mode 
lesdits moyens de radiocommunication gerent uniquement la signalisation d'un 
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REVENDICATIONS 

1. Systeme de contrdle d'equipements a distance, permettant Interconnexion 
entre au moins un serveur et au moins un equipement distant selon le protocole 
MQIsdp, 

caracteTisS en ee qu'il associe a au moins un desdits equipements distants des 
moyens de radiocommunication capable de trailer en interne un protocole de 
communication mettant en oeuvre des fonctions source de type API disponibles 
dans une plateforme logicielle (Open AT) permettant d'embarquer au moins une 
application, 

et en ce que lesdits moyens de radiocommunication sont dotes d'un jeu de 
fonctions (API) specifiques permettant d'echanger des donnees avec au moins un 
serveur mettant en ceuvre ledit protocole MQIsdp, 

de facon a permettre une interconnexion entre le ou lesdits serveurs et le ou lesdits 
equipements distants via lesdits moyens de radiocommunication, ces derniers 
gerant 6galement au moins une application entre le ou lesdits serveurs et le ou 
lesdits equipements distants. 

2. Systeme de contrdle d'6quipements a distance selon la revendication 1, 
caracteris6 en ce que lesdits moyens de radiocommunication comprennent un 
module de radiocommunication, regroupant sur un meme substrat l'ensemble des 
moyens de traitement de donnees radio-frequence et bande de base, ainsi que les 
moyens de gestion desdites fonctions (API) et la ou lesdites applications. 

3. Systeme de contrdle d'equipements a distance selon Tune quelconque des 
revendications 1 et 2, caracteris€ en ce que lesdits moyens de radiocommunication 
integrent ledit protocole MQIsdp sous la forme d'une librairie, ddfinissant ledit 
jeu de fonctions (API) specifiques. 

4. Systeme de contrdle d'equipements a distance selon Tune quelconque des 
revendications 1 a 3, caracterise en ce que, au moins dans un premier mode, 
lesdits moyens de radiocommunication gerent uniquement la signalisation d'un 
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echange de donnees, lesdi ,e S donnas etan. transferees directemen. d'un 
eqmpement distant vers un serveur, ou inversemem. 

5. Systeme de conWle d^uipements » distance selon 1W queIconque des 
revendications . a 4, caracterise en ce que, au moms dans un second mode, .esdits 
moyens de mdiocommumcauon geren. ia signalisadcn d'un echange de donnees 
e. le dansfert desdi.es donnees, ces demieres e.ant .emporairemen. stocks dans 
au moms une memoire tampon. 

«. Systeme de controle d'equipemems a distance se!on la K ve»dication 5 
caracense en ce que ,a * de la o„ desdi.es memoir .ampon es. parametral* ' 

7. Systeme de condole d'equipements a distance selon les revendicadons 4 et 
6, caracense en ce qu'i, foncdonne dans ,edi, prefer mode lorsque ,a uulle de ia 
on desdtfes mteoires tampon van. 0, e. dans ledi. second mode sinon 

8. Systeme de condyle d'equipemems a distance selon 1W que Iconque des 
revendicadons 1 » 7, earache en ce que .edit jeu de foncdons API specifies 
comprend des fonctions peimettant : 

- la connexion a un desdits serveurs ; 

- l'envoi de messages ; 

- la reception de messages ; 

- configuration d'au moins un parametre. 
Systeme de controle d'equipements a distance selon 1'une queIconque des 

revend^ons 1 a 8, caracterise en ce qu'au moins certaines desdites fonctions 
(API) species sont organises de facon a pouvoir assurer au moins deux 
operations et/ou agir sur au moins d.ux aspects distincts, en fonction d'un 
paramettage pr6d€fini. 

» 10. Systeme de console d'equipements » distance selon rune qne,co„ q „e des 

revendicadons 1 a 9, caracterise en ce que ledi. jeu de foncdons (API) comprend 
umquement 12 foncdons. 

U. Systeme de conWle d'equipemems a dis<ance selon IW queIconque des 
revelations 1 a 10, carac.erise en ce que ledi. jeu de foncdons (API) 
species comprend une fonction d'MdaUsadon (mqiadpjm.) rftablissan. des 
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Change de donnees, .esdites donnfes etant directem e n , d'an 

Squipement distant vers tin serveur, ou inversement. 

5. Systeme de comr61e d'equipements a disto.ce selon IWe quelconque des 
revendieations 1 a 4, earacterise en ce que. aa atoms da™ an second mode, lesdfts 
moyens de radiocommanication gereat la signalisation d'un echange de donnees 
et le transfer! desdites donnees, ces dernieres etant temporairenrent stockees dans 
au moins une mdrnoire tampon. 

*. Systeme de contr61e d'eqaipements a distance selon la revocation 5 
earacterise en ce qae la taiUe de la oa desdites memoires tampon est parametrable ' 
7. Systeme de contriMe dNSquipements a distance selon les revendieations 4 et 

6, earacterise en ce qu'il fonctionne dans ledit premier mode lorsqne la taille de .a 
ou desdites memoires tampon vaat 0, et dans ledit second mode sinon. 

S. Systeme de contreie dVSquipements i distance selon Tune quelconque des 
revendicadons , a 7, earacterise en ce que leni. jeu de functions AH specifies " 
comprend des Junctions permettant : 

- la connexion a un desdits serveurs ; 

- l'envoi de messages ; 

- la reception de messages ; 

- configuration d'au moinis un parametre. 

9. Systeme de controle d'6quipements a distance selon Tune quelconque des 
revendieations 1 a 8, earacterise en ce qu'au moins certaines desdites fonctions 
(API) specifiques sont organises de facon a pouvoir assurer au moins deux 
operations et/ou agir sur au moins deux aspects distinct*, en fonction d'un 
param6trage pr&tefini. 

10. Systeme de controle d^quipements 1 distance selon Pane quelconque des 
revendicadons 1 a 9, earacterise en ce que ledit jeu de fonctions (API) comprend 
uniquement 12 fonctions. 

11. Systeme decontreied'equipements a distance selon Tune quelconque des 
revendieations 1 a 10, earacterise en ce que iedit jeu de functions (API) 
specifiques comprend une fonction d-initiahsauon (mqisdpjni.) retablisaan, des 
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parametres par defaut, et devant etre appelee au moins une fois avant l'utilisation 
d'autres fonctions (API). 

12. Systeme de contrdle d'equipements a distance selon Tune quelconque des 
revendications 1 a 11, caracterise en ce que ledit jeu de fonctions (API) 
specifiques comprend une fonction (mqisdp_resume) appelee lorsque une liaison 
IP a ete etablie. 

13. Systeme de controle d'equipements k distance selon Tune quelconque des 
revendications 1 a 12, caracterisS en ce qu'il comprend une fonction 
d'&ablissement d'une connexion avec un desdits serveurs (mqisdp_connect), 
permettant de deTinir des parametres de ladite connexion, et une fonction de 
disconnexion (mqisdp_disconnect) de ladite connexion. 

14. Systeme de contrdle d'equipements a distance selon la revendication 13, 
caracterise en ce que ladite fonction d'etablissement d'une connexion permet de 
selectionner un mode de transmission parmi au moins deux (GSM et GPRS). 

15 15. Systeme de contrdle d'equipements a distance selon l'une quelconque des 

revendications 1 a 14, caracterise en ce qu'il comprend une fonction 
(mqisdp_publish) pour l'envoi d'un message vers un desdits serveurs. 

16. Systeme de controle d'equipements a distance selon l'une quelconque des 
revendications 1 a 15, caracterise- en ce qu'il comprend une fonction 

20 d'abonnement k un desdits serveurs (mqisdp_subscribe), et une fonction de 

desabonnement (mqisdp_unsubscribe) audit serveur. 

17. Systeme de contrdle d'equipements k distance selon l'une quelconque des 
revendications 1 k 16, caracterise en ce qu'il comprend au moins une fonction de 
demande d'information sur au moins un aspect d'une communication en cours. 

25 18 * Systeme de contrdle d'equipements k distance selon la revendication 17, 

caracterise en ce qu'il comprend au moins une des fonctions appartenant au 
groupe comprenant : 

- une fonction de demande du statut d'une connexion 
(mqisdp_getConStatus) ; 

- une fonction de demande du statut d'un message donne 
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parametres par dtfaut, et devant etre appelee au moins une fois avant l'utilisation 
d'autres fonctipns (API). 

12. Systeme de controle d'equipements a distance selon Tune quelconque des 
revendications 1 a 11, caractense - en ce que ledit jeu de fonctions (API) 

5 sp6cifiques comprend une fonction (mqisdp_resume) appelee lorsque une liaison 

IP a 6t6 6tablie. ; 

13. Systeme de controle d'equipements a distance selon Tune quelconque des 
revendications 1 a 12, caractens6 en ce qu'il comprend une fonction 
d'Stablissemerit d'une connexion avec un desdits serveurs (mqisdp_connect), 

10 permettant de deTmir des parametres de ladite connexion, et une fonction de 

deconnexion (mqisdp_disconnect) de ladite connexion. 

14. Systeme de contrdle d'equipements a distance selon la revendication 13, 
caracterise en ce que ladite fonction d'6tablissement d'une connexion permet de 
selectionner un mode de transmission parmi au moins deux (GSM et GPRS). 

15 15. Systeme de contrdle d'6quipements a distance selon Tune quelconque des* 

revendications 1 a 14, caracterisg en ce qu'il comprend une fonction-' 
(mqisdp_publish) pour l'envoi d'un message vers un desdits serveurs. 

16. Systeme de contrdle d'equipements a distance selon Tune quelconque des 
revendications 1 a 15, caracteris6 en ce qu'il comprend une fonction 

20 d'abonnement a un desdits serveurs (mqisdp_subscribe), et une fonction de 

desabonnement (mqisdp__unsubscribe) audit serveur. 

17. Systeme de controle d'equipements a distance selon l'une quelconque des 
revendications 1 a 16, caracterise" en ce qu'il comprend au moins une fonction de 
demande d'information sur au moins un aspect d'une communication en cours. 

25 18 - Systeme de controle d'equipements a distance selon la revendication 17, 

caracterise en ce qu'il comprend au moins une des fonctions appartenant au 
groupe comprenant : 

- une fonction de demande du statut d'une connexion 
(mqisdp__getConStatus) ; 

- une fonction de demande du statut d'un message donne 
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(mqisdp_getMsgStatus) ; 

- une fonction de demande de la taille actuelle d'une file d'attente 
(mqisdp_getQueueSize) ; 

- une fonction de demande de 1'espace disponible dans une file 
d'attente(mqisdp_getAvailableSize). 

Systeme de controle d'equipements a distance, selon Tune quelconque de, 
revocations 1 a 18, earache en ce qu'il comprend une fonction de definition 
de la taille d'une file d'attente (mqisdp.setQueueSize). 

20. Precede de contr61e d'6quipements a distance, pennettant 1'interconnexion 

misl m ° inS Un et " m ° ins " ' quipement distant seIon 16 ~ le 

caracterise en ce qu'il associe a au moins un desdits €quipements distants des 
moyens de radiocommnnication capable de traiter en interne un protocole de 
communication mettant en oeuvre des fonctions source de type API disponibles 
dans une plateforme logicielle (Open AT) permettant d'embarquer au moins une 
application, 

et e» ce qu i! me, en ceuvre. dans lesdits moyens de radiocommunication, un jen 
de fonctions API specifies permetian, d'echanger des donees avec an moins 
un serveur mettant en ceuvre ledit protocole MQIsdp, 

de facon a permed une interconnexion entre .e ou lesdits serveurs et le on lesdits 
fcrncpements distants via lesdits moyens de radiocommumctttion, ces derniers 
gerant egalemen. au moins une application entre ,e ou lesdi* serveurs et le ou 
lesdits equipements distants. 

21. Dispositif de radiocommnnication caracterise en ce qu'il comprend des 
moyens de radiocommnnication mis en oeuvre dans uh systeme de controle 
d'eqmpements i distance selon .toe quelconque des revendications 1419 

22. Module de radiocommnnication caracterise en ce qu'il comprend des 
moyens de radiocommnnication mis' en ceuvre dans un systeme de conWle 
d equipements a distance selon fune quelconque des revendications 1 a 19 

23. Jeu de fonctions (API) mis en oeuvre dans nn systeme de controle 
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(mqisdp__getMsgStatus) ; 

- une f onction de demande de la taille actuelle d'une file d'attente 
(mqisdp_getQueueSize) ; 

- une fonction de demande de l'espace disponible dans une file 
d'attente (mqisdp_getAvailableSize). 

19. Systeme de contr61e d'equipements a distance selon l'une quelconque des 
revendications 1 a 18, caracterise" en ce qu'il comprend une fonction de definition 
de la taille d'une file d'attente (mqisdp_setQueueSize). 

20. Procede de contrdle d'equipements a distance, permettant l'interconnexion 
entre au moins un serveur et au moins un equipement distant selon le protocole 
MQIsdp, 

caracterise en ce qu'il associe a au moins un desdits equipements distants des 
moyens de radiocommunication capable de traiter en interne un protocole de 
communication mettant en oeuvre des fonctions source de type API disponibles 
15 dans une plateforme logicielle (Open AT) permettant d'embarquer au moins iine 

application, 

et en ce qu'il met en ceuvre, dans lesdits moyens de radiocommunication, un jeu 
de fonctions API sp6cifiques permettant d'echanger des donnees avec au moins 
un serveur mettant en ceuvre ledit protocole MQIsdp, 
20 de facon a permettre une interconnexion entre le ou lesdits serveurs et le ou lesdits 

equipements distants via lesdits moyens de radiocommunication, ces derniers 
gerant egalement au moins une application entre le ou lesdits serveurs et le ou 
lesdits Equipements distants. 

21. Dispositif de radiocommunication caracterise" en ce qu'il comprend des 
25 moyens de radiocommunication mis en oeuvre dans un systeme de contr61e 

d'equipements a distance selon l'une quelconque des revendications 1 a 19. 

22. Module de radiocommunication caracterise" en ce qu'il comprend des 
moyens de radiocommunication mis en ceuvre dans un systeme de contrdle 
d'equipements a distance selon l'une quelconque des revendications 1 a 19. 

30 23. Jeu de fonctions (API) mis en oeuvre dans un systeme de contrdle 
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d'equipements & distance, caracterise en ce qu'il permet d'echanger des donndes 
avec au moins un serveur mettant en oeuvre ledit protocole MQIsdp. 
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d'equipements a distance selon l'une quelconque des revendications 1 a 19, 
caracteiise en ce qu'il permet d'echanger des donnees avec au moins un server 
mettant en oeuvre ledit protocole MQIsdp. 
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